home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / ocx / webster / 32-bit / webster.ocx / HTMLPAGE / 246 < prev    next >
Text File  |  1995-08-14  |  10KB  |  135 lines
  1. <HTML><HEAD><TITLE>Webster beta 914</TITLE></HEAD>
  2. <BODY BGCOLOR="#ffffff" TEXT="#0000ff" LINK="#ff0000">
  3. <CENTER><IMG SRC="Webster://Internal/262"></CENTER><p><HR>
  4. <H4>Webster HTML OCX beta 914</H4><p>
  5. Webster <A HREF="#properties">properties</a>, <A HREF="#methods">methods</a>, <A HREF="#events">events</a> and <A HREF="#buttons">buttons</a> are described.
  6. <HR><A NAME="buttons"></a><H4><U>Buttons</U></H4>
  7. The buttons are presented on the title bar, which is usually placed 
  8. at the top of the display area.<P>
  9. <UL>
  10. <LI><A HREF="file:///HotList.htm"><IMG SRC="Webster://Internal/213" ALIGN=TOP></A>
  11. Loads the page for the URL specified by the <tt><b>HomePage</b></tt> property.  The initial setting of the HomePage property is <strong>file:///HotList.htm</strong>.
  12. <LI><A HREF="Webster://Command/dir"><IMG SRC="Webster://Internal/226" ALIGN=MIDDLE></A> Displays a directory of files on the local disk, allows selection.
  13. <LI><A HREF="Webster://Command/history"><IMG SRC="Webster://Internal/253" ALIGN=MIDDLE></A> Displays session history.
  14. <LI><A HREF="Webster://Command/help"><IMG SRC="Webster://Internal/250" ALIGN=MIDDLE></A> Shows a status screen, which presents capture-to-disk options and shows the HTML document source.
  15. Shows this screen when clicked from internal pages (session history, directory).
  16. <LI><IMG SRC="Webster://Internal/230" ALIGN=MIDDLE> Captures the currently displayed WWW page to disk, including embedded images.
  17. <LI><A HREF="Webster://Command/back"><IMG SRC="Webster://Internal/248" ALIGN=MIDDLE></A>
  18. and <A HREF="Webster://Command/forth"><IMG SRC="Webster://Internal/249" ALIGN=MIDDLE></A> page back and forth through history.
  19. <LI><IMG SRC="Webster://Internal/251" ALIGN=MIDDLE> Reloads the current page, 
  20. <IMG SRC="Webster://Internal/252" ALIGN=MIDDLE> indicates an active load - click to cancel.
  21. </UL>
  22. <HR><A NAME="properties"></a><H4><U>Properties</U></H4>
  23.  
  24. <DL>
  25. <dt><tt><b>short BorderStyle</b></tt><dd>Stock property.<p>
  26. <dt><tt><b>short HWnd</b></tt><dd>Stock property.<p>
  27. <dt><tt><b>BOOL Enabled</b></tt><dd>Stock property.<p>
  28.  
  29. <dt><tt><b>short BevelStyleInner</b></tt><dd>Inner bevel style:<p>
  30.  0 - None<br> 1 - Indent<br> 2 - Outdent<p><p>
  31. <dt><tt><b>short BevelStyleOuter</b></tt><dd>Outer bevel style (see BevelStyleInner).<p>
  32. <dt><tt><b>long BevelWidth</b></tt><dd>Bevel width<p>
  33. <dt><tt><b>OLE_COLOR BevelColorTop</b></tt><dd>Color of the flat surface between the bevels.<p>
  34. <dt><tt><b>OLE_COLOR BevelColorDark</b></tt><dd>Bevel shade color.<p>
  35. <dt><tt><b>OLE_COLOR BevelColorLight</b></tt><dd>Bevel highlight color.<p>
  36.  
  37. <dt><tt><b>LPDISPATCH Font</b></tt><dd>Stock property - used in title and URL windows.<p>
  38. <dt><tt><b>LPDISPATCH FontAddress</b></tt><dd>Address font.<p>
  39. <dt><tt><b>LPDISPATCH FontBlockQuote</b></tt><dd>Block quote font.<p>
  40. <dt><tt><b>LPDISPATCH FontDir</b></tt><dd>Directory font.<p>
  41. <dt><tt><b>LPDISPATCH FontExample</b></tt><dd>Example font.<p>
  42. <dt><tt><b>LPDISPATCH FontHeading1</b></tt><dd>Heading 1 font.<p>
  43. <dt><tt><b>LPDISPATCH FontHeading2</b></tt><dd>Heading 2 font.<p>
  44. <dt><tt><b>LPDISPATCH FontHeading3</b></tt><dd>Heading 3 font.<p>
  45. <dt><tt><b>LPDISPATCH FontHeading4</b></tt><dd>Heading 4 font.<p>
  46. <dt><tt><b>LPDISPATCH FontHeading5</b></tt><dd>Heading 5 font.<p>
  47. <dt><tt><b>LPDISPATCH FontHeading6</b></tt><dd>Heading 6 font.<p>
  48. <dt><tt><b>LPDISPATCH FontListing</b></tt><dd>Listing font.<p>
  49. <dt><tt><b>LPDISPATCH FontMenu</b></tt><dd>Menu font.<p>
  50. <dt><tt><b>LPDISPATCH FontNormal</b></tt><dd>Normal font.<p>
  51. <dt><tt><b>LPDISPATCH FontPreformatted</b></tt><dd>Preformatted font.<p>
  52.  
  53. <dt><tt><b>short UrlWindowStyle</b></tt><dd>Determines the visibility and 
  54. position of the URL window:<p> 0 - None<br> 1 - Top<br> 2 - Bottom<p><p>
  55.  
  56. <dt><tt><b>short TitleWindowStyle</b></tt><dd>Determines the visibility and position of the URL 
  57. window (see UrlWindowStyle).<p>
  58.  
  59. <dt><tt><b>CString PageURL</b></tt><dd>Reflects the currently active (visible) page, which may
  60. be an HTML document, pure text or pure image.  Setting this property initiates loading and display of the page
  61. specified by the URL.<p>
  62. <dt><tt><b>CString PageTitle</b></tt><dd>Reflects the page title (read-only)<p>
  63. <dt><tt><b>OLE_COLOR AnchorColor</b></tt><dd>Color of hyperlink text.<p>
  64. <dt><tt><b>CString HomePage</b></tt><dd>URL to be loaded when the HomePage button is clicked.<p>
  65. <dt><tt><b>CString DownloadDir</b></tt><dd>The default directory for downloads and saved files.<p>
  66. <dt><tt><b>long PagesToCache</b></tt><dd>The number of pages to cache.<p>
  67. <dt><tt><b>OLE_COLOR BackColor</b></tt><dd>Stock property - the default page background color.<p>
  68. <dt><tt><b>BOOL IgnoreBaseInFile</b></tt><dd>Causes any BASE tag URL to be ignored when constructing full URLs from partial
  69. references. In addition, image references are treated as partial references (based on the underlying page URL) even
  70. when fully qualified.  This is useful when loading a page which has been captured to local disk, since images which are
  71. available on local disk are retrieved from there rather than from the original (remote) source,
  72. and so are hyperlinked pages.<p>
  73. <dt><tt><b>short LoadStatus</b></tt><dd>A status code for the currently active page:<p>
  74.  0 - Page load done.<br>
  75.  1 - Connecting to host.<br>
  76.  2 - Connected, waiting.<br>
  77.  3 - Page text loading.<br>
  78.  4 - Images loading.<br>
  79.  5 - Load failed.<p>
  80. <dt><tt><b>OLE_COLOR ForeColor</b></tt><dd>Stock property - default for text.<p>
  81. <dt><tt><b>long MaxSockets</b></tt><dd>Maximum number of sockets <em>per page load</em>.<p>
  82. <dt><tt><b>long MaxPageLoads</b></tt><dd>Maximum number of concurrent page loads allowed.<p>
  83. <dt><tt><b>long MarginHorizontal</b></tt><dd>The horizontal margin in pixels.<p>
  84. <dt><tt><b>long MarginVertical</b></tt><dd>The top margin in pixels.<p>
  85. <dt><tt><b>BOOL LoadImages</b></tt><dd>Determines whether embedded images are loaded.<p>
  86. <dt><tt><b>BOOL ShowReferer</b></tt><dd>HTTP Referer header switch.<p>
  87. <dt><tt><b>CString AuthenticName</b></tt><dd>Name for Basic authenication.<p>
  88. <dt><tt><b>CString AuthenticPassword</b></tt><dd>Password for Basic authentication.<p>
  89. <dt><tt><b>CString FromName</b></tt><dd>HTTP From header field.<p>
  90. <dt><tt><b>CString BrowserName</b></tt><dd>HTTP User-Agent header field.<p>
  91. <dt><tt><b>long ButtonMask</b></tt><dd>Enables title window buttons: low order to high order
  92. bits enable buttons from left to right.<p>
  93. <dt><tt><b>CString ProxyServerHTTP</b></tt><dd>Proxy server name.<p>
  94. <dt><tt><b>long ProxyPortHTTP</b></tt><dd>Proxy server port.<p>
  95. </DL>
  96. <HR><A NAME="methods"></a><H4><U>Methods</U></H4>
  97. <dl>
  98. <dt><tt><b>void AboutBox()</b></tt><dd>Stock method.<p>
  99. <dt><tt><b>short Cancel()</b></tt><dd>Cancels the loading of the current (visible) page, if it is loading.  Harmless otherwise.<p>
  100. <dt><tt><b>short DismissPage(LPCTSTR URL)</b></tt><dd>Removes the page from cache.<p>
  101. <dt><tt><b>long GetContentSize(LPCTSTR URL)</b></tt><dd>Byte count for the specified page, according to the header.<p>
  102. <dt><tt><b>long GetContentSizeRead(LPCTSTR URL)</b></tt><dd>Actual byte count available in the specified page.<p>
  103. <dt><tt><b>CString GetContentType(LPCTSTR URL)</b></tt><dd>The content type string for the page, from the header.<p>
  104. <dt><tt><b>CString GetContent(LPCTSTR URL, long StartOffset, long Length)</b></tt><dd>Retrieves a range of raw bytes from the page.<p>
  105. <dt><tt><b>short GetHiddenFlag(LPCTSTR URL)</b></tt><dd>Returns the hidden state of the page.<p>
  106. <dt><tt><b>short SetHiddenFlag(LPCTSTR URL, BOOL Hidden)</b></tt><dd>Causes the specified page to be concealed or revealed.<p>
  107. <dt><tt><b>long GetLinkCount(LPCTSTR URL)</b></tt><dd>Return the number of hyperlinks in the page.<p>
  108. <dt><tt><b>CString GetLinkURL(LPCTSTR URL, long Index)</b></tt><dd>Gets the specified URL from the page.<p>
  109. <dt><tt><b>CString GetRedirectedURL(LPCTSTR URL)</b></tt><dd>Final URL corresponding to the specified URL, after any redirection.<p>
  110. <dt><tt><b>short GetStatus(LPCTSTR URL)</b></tt><dd>Returns a status code for the specified page (see LoadStatus).<p>
  111. <dt><tt><b>long GetTextSize(LPCTSTR URL)</b></tt><dd>Returns the byte count of pure text, no tags.<p>
  112. <dt><tt><b>CString GetText(LPCTSTR URL, long StartOffset, long Length)</b></tt><dd>Extracts pure text from the page, no tags.<p>
  113. <dt><tt><b>CString GetTitle(LPCTSTR URL)</b></tt><dd>Returns the page title.<p>
  114. <dt><tt><b>short LoadPage(LPCTSTR URL, short Hidden)</b></tt><dd>Initiates a page load.<p>
  115. <dt><tt><b>void Refresh()</b></tt><dd>Stock method.<p>
  116. <dt><tt><b>short SaveToDisk(LPCTSTR FileName)</b></tt><dd>Save the current page to disk, synthesizing a file name if necessary.  The
  117. file is written to the directory specified by the <tt><b>SaveDir</b></tt> property.<p>
  118. </dl><p>
  119. <HR><A NAME="events"></a><H4><U>Events</U></H4>
  120. <dl>
  121. <dt><tt><b>void DoClickURL(BSTR* SelectedURL, BOOL* Cancel)</b></tt><dd>This event is fired when the user clicks on a hyperlink.
  122. An interested container may inspect the clicked URL in <tt><b>stringURL</b></tt> and take one of the following courses:<p>
  123. <ul>
  124. <li> Do nothing, and the page specified by the URL will be loaded.
  125. <li> Set the <tt><b>boolCancel</b></tt> argument to TRUE (non-zero), causing the user click to be ignored.
  126. <li> Replace the contents of <tt><b>stringURL</b></tt> with another URL, which will be loaded instead.
  127. </ul>
  128. <p>
  129. <dt><tt><b>void KeyDown(short* KeyCode, short Shift)</b></tt><dd>Stock event.<p>
  130. <dt><tt><b>void LoadComplete(BSTR* URL, short Status)</b></tt><dd>When a page load is finished,
  131. this event conveys the load status.
  132. </dl>
  133. <HR>
  134. <A HREF="Webster://Internal/211#ftpSite">Return</A> to the intro page.</body></HTML>
  135.